home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / dview31.zip / DVIEW.DOC < prev    next >
Text File  |  1990-01-08  |  6KB  |  132 lines
  1. DVIEW DVI File Viewer   version 3.1       Steve Ward & Ricardo Jenez 10/89
  2.  
  3. DVIEW is a program for IBM PC compatibles for viewing TeX .dvi output
  4.  files, including those using the MIT graphics extensions.  Currently
  5.  DVIEW supports the CGA, EGA, VGA, and the high-resolution mode of the
  6.  Toshiba T3100 (& presumably the AT&T 6300); other displays may be
  7.  supported in time.
  8.  
  9. QUICK START:  You can get DVIEW up and running, and read a TeX-formatted
  10.  version of this information, by moving PXL files from this archive
  11.  to the appropriate subdirectories, and typing "DVIEW DVIEW".  To do
  12.  so without reading further (on a PC with CGA-compatible display),
  13.  type "RUNME".
  14.  
  15. OVERVIEW: DVI files are standard and machine-independent; they may
  16.  be generated on the PC or downloaded from another source.  Viewing
  17.  them requires DVIEW plus a set of appropriate font files, which again
  18.  are standard Metafont output (PXL or PK) files and can be downloaded from
  19.  any of a variety of sources.  DVIEW reads each page and builds a
  20.  virtual bitmap (in RAM), then blts segments onto your display as you
  21.  move around the virtual page (using arrow keys).  During the building
  22.  process DVIEW shows its progress via a reduced image of the page; this
  23.  overview is recoverable by pressing "?" subsequently.  The size and 
  24.  shape of the virtual page, as well as a scale factor, are variable
  25.  via obscure command-line arguments (see below); they default to values
  26.  which allow most papers to just fit horizontally, requiring scrolling
  27.  only in the vertical dimension.
  28.  
  29. FONT FILES: By default, these live in a subtree /PXL on your PC.  /PXL
  30.  contains subdirectories with numeric names like /PXL/480, indicating
  31.  resolution; entries in the subdirectories are PXL or PK files with names
  32.  like /PXL/480/CMR10.PXL or CMR10.PK, indicating the font.  You need only to
  33.  download the specific files used by your paper -- a reasonably complete
  34.  set can run into many megabytes.  To help you manage fonts, DVIEW
  35.  (1) after warning you, will try to substitute a smaller font of the
  36.  same style for any missing fonts; (2) allows you to review the font
  37.  situation using the "f" command; and (3) writes out a file "MISSING.FNT"
  38.  which indicates the additional fonts you need to download.  MIT users
  39.  can do a MAKE from /archive/pxl, which accesses MISSING.FNT in the
  40.  local directory and downloads the necessary fonts.  Presumably
  41.  this situation can be duplicated elsewhere; look in hx:/archive/pxl
  42.  for our local PC-appropriate font cache.
  43.  
  44.  Note: As of release 3.0, designated bitmap font resolutions are 5X
  45.  smaller than the one previously used, following the convention which
  46.  seems to have changed with the advent of cm fonts; eg. what was pixel 
  47.  size 480 is now 96. The old scaling can be obtained by using the "-a"
  48.  command line option as mentioned below.
  49.  
  50. PICTURES: DVIEW understands the simple M.I.T. extensions for drawing lines,
  51.  allowing pictures (created e.g. using GEDIT on the PC) in TeX
  52.  documents to be viewed.  See DVIEW.DVI for a simple example.
  53.  
  54. DVIEW.TMP: Because font loading takes some time (a LOT on an old PC,
  55.  a few seconds even on the T3100) DVIEW offers the "t" command (or
  56.  "-t" command line option) to cause a dump of its fonts and parameters
  57.  into a fast-load file DVIEW.TMP.  If DVIEW finds DVIEW.TMP on a
  58.  subsequent invocation, it loads it and presumably restores your
  59.  parameters (including display type) and fonts.  This step is worth
  60.  taking if you will be repeatedly viewing edited versions of the same
  61.  file.  You can delete DVIEW.TMP and/or make a new one at any point,
  62.  eg if you change the set of fonts you are using.
  63.  
  64. COMMAND SUMMARY: Once in DVIEW viewing a page, you can type:
  65.  
  66.           ?  HELP information (this summary)
  67.          UP  move page up
  68.        DOWN  move page down
  69.        LEFT  shift page left
  70.       RIGHT  shift page right
  71.        HOME  top of page
  72.         END  bottom of page
  73.        PgUp  double step size
  74.        PgDn  halve step size
  75.           t  write state into DVIEW.TMP
  76.           f  show font list
  77.           p  Print (low-res) page
  78.     <digit>  enter new page number
  79.       SPACE  next page
  80.      BACKSP  previous page
  81.      RETURN  back to page 1
  82.         TAB  skip to last page
  83.         ESC  return to MS-DOS
  84.  
  85.  plus a few which I've probably forgotten.  Poke around a little.  Note
  86.  that the above info is online.
  87.  
  88. When fired up with no arguments, DVIEW gives you the following terse
  89.  command line help:
  90.  
  91. DVIEW DVI File Viewer   version 3.1   Steve Ward & Ricardo Jenez
  92. DVIEW <options> <dvifile>     [version 3.1]
  93.  <options> or DVIEW envstring may include:
  94.     -x# adjusts horizontal page offset. [default: 65]
  95.     -y# adjusts vertical page offset. [40]
  96.     -R# sets resolution to # [default 96; try 80]
  97.     -F<path> sets font directory to <path> [/pxl]
  98.     -X# set virtual page X size, in BYTES. [90]
  99.     -Y# set virtual page Y size, in LINES. [1000]
  100.     -m# sets page map width to #. [300]
  101.     -dc sets display to type c (c=cga,t=T3100,e=ega, v=vga)[?]
  102.     -t  writes DVIEW.TMP as font/parameter cache
  103.     -t<name>  writes <name> as font/parameter cache
  104.     -a  use pre version 3.0 font designation (5 times larger)
  105.     -cx# sets color (x=a, b, c, ...)
  106.  
  107. If you are wildly experimental and don't like the parameters DVIEW defaults
  108.  to, you can try some of the above.  Start with "dview file" (or, on e.g. a
  109.  T3100, "dview -dt file") and play a little.
  110.  
  111. ENVIRONMENT VARIABLE: When invoked, DVIEW looks for a value bound to
  112.  the environment variable DVIEW, and interprets it as command line
  113.  options.  Thus, for example, the line
  114.  
  115.      set DVIEW = -de -F/tex/fonts/
  116.  
  117.  in your AUTOEXEC.BAT file causes DVIEW to assume by default an EGA and
  118.  the subdirectory tree /TEX/FONTS/... for fonts.
  119.  
  120.  
  121.  
  122. \Section{Distribution}
  123.  
  124. DISTRIBUTION: DVIEW may be freely distributed, and used for any purpose
  125.  by anybody.  If you can figure out how to make money from it despite the
  126.  fact that I'm giving it away, you're welcome to.  I like the idea that
  127.  free software is free -- that is, completely unencumbered.
  128.  
  129.  
  130. (end)
  131.  
  132.